Geeft als resultaat een Variant (Integer) met het opgegeven deel van een bepaalde datum.
Syntaxis
DatePart(interval, date[,firstdayofweek[, firstweekofyear]])
De functie DatePart heeft de volgende benoemde argumenten:
| Onderdeel | Beschrijving |
|---|---|
| interval | Vereist. Een reeksexpressie die het tijdsinterval aangeeft dat u als resultaat wilt. |
| date | Vereist. Variant (Date)-waarde die u wilt evalueren. |
| eerstedagvanweek | Optioneel. Een constante die de eerste dag van de week aangeeft. Als er niets wordt opgegeven, wordt zondag gebruikt. |
| eersteweekvanjaar | Optioneel. Een constante die de eerste week van het jaar aangeeft. Als er niets wordt opgegeven, wordt de week gebruikt waarin 1 januari valt. |
Instellingen
Het argument interval heeft de volgende instellingen:
| Instelling | Beschrijving |
|---|---|
| yyyy | Jaar |
| q | Kwartaal |
| m | Maand |
| y | Dag van het jaar |
| d | Dag |
| w | Dag van de week |
| ww | Week |
| h | Uur |
| m | Minuut |
| s | Seconde |
Het argument firstdayofweek heeft de volgende instellingen:
| Constante | Waarde | Beschrijving |
|---|---|---|
| vbUseSystem | 0 | Gebruikt de NLS API-instelling. |
| vbSunday | 1 | zondag (standaardinstelling) |
| vbMonday | 2 | maandag |
| vbTuesday | 3 | dinsdag |
| vbWednesday | 4 | woensdag |
| vbThursday | 5 | donderdag |
| vbFriday | 6 | vrijdag |
| vbSaturday | 7 | zaterdag |
Voor het argument eersteweekvanjaar kunt u de volgende instellingen opgeven:
| Constante | Waarde | Beschrijving |
|---|---|---|
| vbUseSystem | 0 | Gebruikt de NLS API-instelling. |
| vbFirstJan1 | 1 | De week waarin 1 januari valt (standaardinstelling). |
| vbFirstFourDays | 2 | Begint met de eerste week waarvan ten minste vier dagen in het nieuwe jaar vallen. |
| vbFirstFullWeek | 3 | Begint met de eerste week waarvan alle dagen in het nieuwe jaar vallen. |
Notities
De functie DatePart kan worden gebruikt om een datum te evalueren en een bepaalde tijdsinterval als resultaat te geven. U kunt DatePart bijvoorbeeld gebruiken om de dag van de week of het huidige uur te berekenen.
Het argument firstdayofweek is van invloed op berekeningen die de intervalsymbolen 'w' en 'ww' gebruiken.
Als datum een letterlijke datum is, wordt het opgegeven jaar een permanent onderdeel van die datum. Indien datum echter is omsloten door dubbele aanhalingstekens (" ") en u het jaar weglaat, wordt het huidige jaar iedere keer dat de expressie datum wordt berekend, in uw code ingevoegd. Hiermee wordt het mogelijk code te schrijven die in verschillende jaren kan worden gebruikt.
Opmerking Als de instelling van de eigenschap Calendar voor datum Gregoriaans is, moet een Gregoriaanse datum worden opgegeven. Als de kalender Hijri is, moet de opgegeven datum ook Hijri zijn.
Het datumonderdeel dat als resultaat wordt gegeven, is uitgedrukt in de tijdsperiode-eenheden van de huidige Arabische kalender. Als de huidige kalender bijvoorbeeld Hijri is en als het datumonderdeel dat als resultaat moet worden gegeven het jaar is, is de jaarwaarde een Hijri-jaar.